Tinn-R
Adaptation de Tinn comme éditeur de scripts pour R
Tinn (http://tinn.solarvoid.com) est un éditeur de texte simple écrit à l'aide de Borland Delphi. Il est gratuit (distribué sous licence GPL, “GNU Public License”) et il est disponible pour les plateformes Windows.
Tinn-R (http://www.sciviews.org/Tinn-R) a démarré comme une adaptation de Tinn pour le rendre plus apte à éditer des scripts R. Cette adaptation est réalisée par une équipe composée de José Cláudio Faria/UESC/Brésil, Philippe Grosjean/UMH/Belgique, Marco de Groot/Mattic Software/Hollande et leurs collaborateurs. Jusqu'ici, Tinn-R a été testé sous Windows 98, 2000 et XP.
Des ressources nouvelles, non disponibles dans le projet Tinn initial ont été ajoutées progressivement. Ainsi, Tinn-R est devenu progressivement un projet distinct.
Caractéristiques principales (Tinn-R)
1. Coloration syntaxique de code R.
2. Menu et barre d'outils spécifiques pour R.
3. Permet de travailler avec les interfaces utilisateur R suivantes:
- Rgui,
- R Console (Rgui en mode SDI),
- SciViews R Console (fourni par SciViews-R, voir http://www.SciViews.org/SciViews-R).
4. Permet aussi de travailler avec S-PLUS.
Démarrer avec Tinn-R
1. Commencez par spécifier vos préférences dans 'Options/Main/Application': comment voulez-vous visualiser le menu et la barre d'outils spécifiques de R, comment voulez-vous appeler les “call-tips” (tips qui vous remémorent la syntaxe des fonction R au fur et à mesure que vous écrivez votre code):
2. Le menu et la barre d'outils spécifiques de R sont maintenant visibles dans Tinn-R:
3. Si vous le désirez, vous pouvez adapter les schémas de couleur pour la coloration syntaxique:
4. N'utilisez pas d'accents ou de symboles (@, #, $, %, ^, &) dans les chemins d'accès ou les noms de fichiers de vos scripts R! Ceci peut causer des dysfonctionnements du programme.
5. Prenez maintenant quelques secondes pour explorer le menu spécifique de R dans Tinn-R.
5.1. Send to R: ce sont plusieurs fonctions qui permettent d'envoyer une partie ou l'ensemble du code édité dans R pour son évaluation. Vous pouvez “sourcer” le fichier tout entier ('Send file'), envoyer une selection ('Send selection'), ou l'ensemble du code ('Send all') contenu dans le document courant. Vous pouvez également évaluer toute la ligne courante ('Send line'), ou depuis la ligne courante jusqu'à la fin du document ('Line to end of page'). Vous pouvez même évaluer une partie de la ligne courante: ('Cursor to end' ou 'Cursor to beginning' of line).
5.2. Controlling R: ce sont des raccourcis pratiques pour effectuer diverses commandes courantes dans R directement depuis Tinn-R. Vous pouvez inspecter le contenu de la variable actuellement sélectionnée dans votre code, soit en imprimer le contenu ('Print content'), soit en lister les noms de variables ('List names'). Vous pouvez lister tous les objets actuellement en mémoire dans l'environnment utilisateur de R ('List all objects'), ou les effacer tous ('Remove all'). Vous pouvez nettoyer votre environments de travail dans R en effaçant la fenêtre console ('Clear console'), en fermant toutes les fenêtre graphiques ('Close all graphic devices'), ou même en effaçant tout ('Clear all'). Attention dans ce cas: vous effaçer toutes la variables dans l'environnement utilisateur, vous nettoyez la fenêtre console et vous fermez toutes les fenêtres graphiques en une seule opération... à utiliser avec discernement!
6. La barre d'outils spécifique de R peut être arrimée où vous voulez: en haut, en bas, ou bien encore à gauche ou à droite à l'opposé de la fenêtre 'Tools' (celle qui contient les onglets 'Computer' et 'Project'). Vous pouvez aussi la faire flotter au dessus de la fenêtre principale si vous préférez.
7. Les fichiers qui ont une extension *.r, *.R, *.q et *.Q sont automatiquement reconnus comme des scripts R/S. La coloration syntaxique et les outils spécifiques de R sont activés pour ces fichiers.
8. Tinn-R propose une fonction pratique d'aide à la saisie des arguments dans une fonction R (call-tips):
9. Vous pouvez exécuter votre code ligne après ligne dans R. Il est recommandé de placer les fenêtres des deux applications (Rgui/R Console et Tinn-R) d'une manière pratique pour voir l'ensemble, et aussi d'activer 'Options/On top' dans Tinn-R de façon à ce que sa fenêtre reste toujours visible au dessus de R. Cliquez à la souris sur le quatrième bouton de la barre d'outils R dans Tinn-R. La ligne courante est exécutée et le curseur se déplace au début de la ligne suivante. Des clics répétés sur ce bouton permettent donc de progresser dans le code ligne par ligne et de visualiser le résultat dans R simultanément.
9.1. Tinn-R avec R Console (Rgui.exe en mode SDI):
9.2. Tinn-R avec Rgui (Rgui.exe en mode MDI, par défaut):
9.3. Tinn-R avec SciViews R Console:
9.3. Tinn-R avec S-PLUS:
Nous remercions tous ceux qui ont participé au test de ce programme, ceux qui nous ont envoyé des suggestions et ceux qui ont stimulé son développement, particulièrement dans ses versions préliminaires, en particulier Anderson Barbieri (coordinateur de l'équipe de développement de l'éditeur 'Notes': http://notes.codigolivre.org.br/). Nous remercions également tous ceux dont les noms sont listés dans 'Help/About/Aknowledgments' de Tinn-R.
Tinn-R team, 4 avril 2005